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Element. 


Incal! Service 


Attributes. 


title 


Children: 


Service 


Description: 


A container. A high level tag that marks the start and end of the XML file. Required. 






Element: 


Service 


Attributes. 


name 


Parents 


Incall Service 


Children: 


DN1S j Service description | Multicall | Percall | Reset 


Description 


A container The parameters in this container describe a service running on a particular phone line (DNIS). 
Each line running Incall Service must have a service described for that line. Required. 






Element: 


DNIS 


Parents. 


Service 


Description. 


The number the caller dialed to reach the application. Required. 






Element: 


Servicedescrrption 


Parents: 


Service 


Description: 


Audio. The description of the service. This audio is played to reassure the caller that they have dialed the right 
number. Fits the carrier phrase, "Hello You have reached <System description^" Required 






Element: 


Multicall 


Parents: 


Service 


Children 


CaHjnfo | Authentication | Content j Choices | Value entry 


Description" 


A container. The parameters specified in Multicall are to be used as default values for ail the calls for the 
service specified in Service. Any tag may be specified in Multicall. Parameters set here act as default values 
for all calls for that service until another Multicall file for that service is specified. Optional. 






Element. 


Percall 


Parents: 


Service 


Children - 


Call 


Description: 


A container Contains the list of calls to be made, one call per Call tag. Required if no Multicall tag specified. 






Element: 


Call 


Attributes: 


id 


Parents: 


Percall 


Children: 


Call info | Authentication } Content | Choices | Value entry | Reset 


Description: 


A container. Contains information for a specific call. Required if there is a Percall tag. 








Element: 


Reset 


Parents: 


Service | Call 


Description 


Resets/Cancels a particular call (if used as a child for Call) or all potential calls for a particular service (if used 
as a child for Service). Optional- 






Element - 


Call info 


Parents: 


Multicall | Call 


Children: 


Phone number j Response url 


Description: 


A container Contains information about the call, beyond the dialog. Required rn either Multicall or Call or 
both. 
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Element: 


Authentication 


Parents: 


Multicall | Call 


Children: 


Authenttcation_code description | Authentication_code | Expectedcaller 


Description 


A container. Contains tags that specify the information necessary for ensuring that the caller is authorized to 
use the service Authentication is indicated if there is an authentication_code passed in from the customer's 
application. If there is an authentication_code, there must also be a description of that code. Optional. 






Element: 


Content 


Parents: 


Multicall | Call 


Description. 


Audio The content message to be played to the caller The content may be an audio file (*.wav), a text file 
(*-txt), or raw text (enclosed m double quotes ) Optional. 






Element. 


Value_entry 


Parents: 


Multicall | Call 


Attributes: 


mindigits | maxdigits 


Description: 


Audio. A description of the entry to be entered by the called party. Must fit carrier phrase, "Please enter.. " 
and "You will be asked for . " Either Choices or Value_entry, but not both, may be specified. Optional- 






Element. 


Choices 


Parents. 


Multicall | Call 


Children: 


Choice | Transfer 


Description' 


A container. Contains information about the list of choices that will be presented to the caller during the call 
Optional. 






Element: 


Phone number 


Parents. 


Call info 


Description: 


Phone number from which Expected_caller is expected to call. Required. 














Element: 


Expected caller 


Parents: 


Authentication 


Description: 


Audio. The name of the person expected to be catling from a given phone number Optional. 








Element: 


Responseurl 


Parents: 


Call info 


Description: 


URL that Incall Service is to use to return status information about the call to the customer application. 
Optional. 






Element: 


Authentication code description 


Parents. 


Authentication 


Description: 


Audio. Description of the authentication code the caller will be asked to enter Fits the carrier phrase, "Please 
enter <authentication_code_descnption>." For example, "Please enter your account number " Required for 
each_ Authentication tag 
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Element: 


Authentication code 


Parents: 


Authentication 


Description: 


The digit string value of the caller's authenticatjon_code_descnption That is, the Authentication_code is the 
value that the caller must enter in order to continue with the call Required for each Authentication tag. 






Element: 


Choice 


Parents: 


Choices 


Children: 


Choice description | Choice_value 


Description. 


A container. Describes the choices that are available to the caller. There is usually more than one Choice tag 
per Choices tag Optional. 






Element: 


Transfer 


Parents: 


Choices 


Children: 


Transfer description { Transfer number 


Description 


A container. Describes the transfer option available to the caller. If there is a transfer option, the value that the 
caller presses is "0" in order to transfer. Only one Transfer tag is allowed per Choices tag. Optional. 






Element: 


Choice description 


Parents: 


Choice 


Description 


Audio. Describes the option the caller may choose. Fits the earner phrase, "If you would like 
<choice description^ press one." Required for each Choice tag. 






Element: 


Choice value 


Parents: 


Choice 


Description: 


A single digit number that indicates the touch-tone that the caller should press in order to select the associated 
choice. Note that if there is a Transfer tag, "0" cannot be used for a Choicejvalue. Required for each Choice 
tag. 














Element: 


Transfer description 


Parents: 


Transfer 


Description: 


Audio. Describes the person or thing (e.g., IV R) the caller would be transferred to should they press zero. 
Required for each Transfer tag. 






Element: 


Transfer number 


Parents. 


Transfer 


Description 


The phone number to which the caller would be transferred, if they press zero. Required for each Transfer tag. 
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Incall Mfile SCI l.xml 



<?xml version^ 1.0?> 

<Incall Service title=" Joe's Sales M file"> 

<Service name= n movie sales"> 
<DNIS>5 1 2290000 1</DNIS> 

<Service_description>"Joe t s Movie Sales"</Service_description> 

<Multicall> 
<Authentication> 

<Authentication_code_description>"movie pin"</Authentication_code_description> 
</Authentication> 

<Choices> 
<Choice> 

<Choice_description>C:\Mob\purchase_DVD.wav</Choice_description> 

<Choice_value>l</Choice_value> 
</Choice> 
<Choice> 

<Choice_description>C:\Mob\purchase_movie_video.wav</Choice_description> 
<Choice_value>2</Choice_value> 
</Choice> 



<Choice_description>C:\Mob\purchase_soundtrack.wav</Choice_description> 
<Choice_value>3</Choice_value> 
</Choice> 

<Transfer> 

<Transfer_description> n Kathy t s phone"</Transfer_description> 
<Transfer_number>460</Transfernumber> 
</Transfer> 

</Choices> 
</Multicall> 
</Service> 

<Service name="theater sales"> 
<DNIS>5 1 22900003</DNIS> 

<Service description> ,T Joe 1 s Stage Productions Stuff Sales"</Service_description> 
<Multicall> 



<Choice> 





<Authentication> 

Authentication code description>"theater pin"</Authentication_code_description> 
</Authentication> 

<Choices> 
<Choice> 

<Choice_description>C:\Mob\purchase_theater_video.wav<VChoice_description> 
<Choice_value> 1 </Choice_value> 
</Choice> 

<Choice> 
<Choice_description>C:\Mob\pur^^ 
<ChoicevaIue>2</Choicevalue> 
</Choice> 
</Choices> 
</Multicall> 
</Service> 

</Incall Service> 
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Element: 


Out call service 


Attributes: 


title 


Children* 


Multicall j Percall 


Description: 


A container. A high level tag to mark the start and end of the XML file. Required. 




Element: 


Service 


Attributes: 


name 


Parents: 


Outcall service 


Children: 


Service description | Multicall | Percall | Reset 


Description: 


A container The parameters in this container describe a service. There can be several services set up for 
Outcall. This tag allows the developer to group Multicall values. Required. 




Element: 


Multicall 


Parents: 


Service 


Children: 


Call_info [ Introduction | Authentication | Content | Value_entry | 
Choices 


Description: 


A container. Indicates that the parameters specified are to be used as default values for all the calls. Any tag 
may be specified in multicall. Parameters set here act as default values for all calls until another multicall 
file is specified Optional. 




Element: 


Percall 


Parents: 


Service 


Children: 


Call 


Description: 


A container. Contains the list of calls to be made, one call per Call tag. Required if no Multicall tag 
specified. 




Element: 


Reset 


Parents: 


Service | Call 


Description: 


Resets values for parent tag and all its children tags already specified. Useful for canceling queued calls 
before they're made. Optional. 




Element: 


Call 


Attributes: 


id 


Parents: 


Percall 


Children: 


Call_info | Introduction | Authentication | Content | Value entry j 
Choices | Reset 


Description: 


A container. Contains information for a specific call. Required if there is a Percall tag 




Element: 


Call info 


Parents: 


Multicall | Call 


Children: 


Phone_number | Response^url | Ensure completion 


Description: 


A container. Contains information about the call, beyond the dialog. Required in either Multicall or 
Call or both. 




Element: 


Introduction 


Parents: 


Multicall j Call 


Children: 


Recipient j Sender 


Description: 


A container. Contains the information for the introduction portion of the call, the sender and the desired 
recipient. Required in either Multicall or Call or both. 
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Element: 


Authent i cat ion 


Parents: 
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Children: 


Authentication code description [Authentication code 


Description: 


A container. Contains tags that specify the information necessary for ensuring that the called party is the 
intended recipient of the call. Optional Authentication is indicated if there is an 
authent i cat ion_code passed in from the customer's application. If there is an 
authent i cat ion_code, there must also be a description of that code and a recipient. 




Element: 


Content 


Parents: 


Multicall [Call 


Description: 


Audio. The content message to be played to the called party. The content may be an audio file (* wav), a 
text file (*.txt), or raw text {enclosed in double quotes ) Optional. 




Element: 


Value_ent ry 


Paients: 


Multicall | Call 


Attributes: 


mindigits | maxdigits 


Description: 


Audio. A description of the entry to be entered by the called party. Must fit carrier phrase, "Please 
enter—" and "You will be asked for..." Either Choices or Value_entry, but not both, may 
be specified. Optional. 




Element: 


Choices 


Parents: 


Multicall | Call 


Children: 


Choice | Transfer 


Description: 


A container. Contains information about the list of choices that will be presented to the user during the call 
Either Choices or Value_entry, but not both, may be specified. Optional. 




Element: 


Phone number 


Parents: 


Call info 


Description: 


Phone number to be called. Must include every digit that is to be dialed (e.g., 9 to get an outside line, 1 for 
long distance). Required. 




Element: 


Response url 


Parents: 


Call info 


Description: 


URL that Outcall service is to use to return status information about the call to the customer application 
Optional. 




Element: 


Ensure_complet i on 


Parents: 


Call info 


Description: 


The number of times that Outcall service will call a person back, if the person has authenticated. These 
callbacks increase the likelihood of the completion of a desired call that was dropped accidentally (for 
instance, by the network). Optional. Default is 0. 




Element: 


Recipient 


Parents: 


Introduction 


Description: 


Audio. Usually text to be converted to speech. Fits the carrier phrase, "This is an automated 
cal 1 for < Recipient from <Sender>. " If Recipient is omitted from the XML, no authentication is 
done; rather, the called party is asked to press 1 to continue. Optional. 




Element: 


Sender 


Parents: 


Introduction 


Description: 


Audio. Fits the carrier phrase, "This is an automated call from <Sender> " Required 




Element: 


Authent ication_code description 


Parents: 


Authentication 


Description: 


Audio Description of the authentication code the called party wilt be asked to enter Fits the carrier phrase^ 
"Please enter <authentication_code_description>." For example, "Please enter your 
account number. " Required for each Authentication tag. 
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Element: 


Authentication code 


Parents: 


Authentication 


Description: 


The digit string value of the called party's authentication_code description. That is, the 
Authentication_code is the value that the called party must enter in order to continue with the call. 
Required for each Authentication tag. 




Element: 


Choice 


Parents: 


Choices 


Children: 


Choi ce_de script ion | Choicejvalue 


Description. 


A container. Describes the choices that are available to the called party. There is usually more than one 
Choice tag per Choices tag. Optional 




Element: 


Transfer 


Parents: 


Choices 


Children: 


Transfer description | Transfer number 


Description: 


A container. Describes the transfer option available to the called party. If there is a transfer option, the 
value that the called party presses is "0" in order to transfer Only one Transfer tag is allowed per 
Choices tag. Optional. 




Element: 


Choicedescript ion 


Parents: 


Choice 


Description : 


Audio. Describes the option the called party may choose. Fits the carrier phrase, "If you would like 
<choice__description>, press one." Required for each Choice tag. 




Element: 


Choice value 


Parents: 


Choice 


Description: 


A single digit number that indicates the touch-tone that the called party should press in order to select the 
associated choice. Note that if there is a Transfer tag, "0" cannot be used for a Choice value- 
Required for each Choice tag. 




Element: 


Transf er_descript ion 


Parents" 


Transfer 


Description: 


Audio. Describes the person or thing the called party would be transferred to should they press zero. 
Required for each Transfer tag. 




Element: 


Transfer number 


Parents: 


Transfer 


Description: 


The phone number to which the called party would be transferred, if they press zero. Required for each 
Transfer tag. 
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1 . Multi-call content definition file: OM l_short.xml 

This XML file defines a hypothetical outcall use case where every called party will be 
presented with a short audio review of a movie. Then, users will be presented with a 
menu of two choices (purchase the DVD or purchase the video) or transferring to a call 
center. 



<?xml version^ * 1 .0 ' ?> 

<Outcall service title= "Outcall Test M file"> 

<Multicall> 

<Call_info> 

<Response_url>http: //vpl- 
mars/ servlet/Outcall_serviceResponse< /Response_url > 

</Call_inf o> 

•eContent >C: \SmartOutcall\Sounds\princess_bride_x2 . wav</Content> 
<Choices> 

<Choice> 

<Choice_description> 

C:\SmartOutcall\Sounds\purchase_DVD.wav 
</Choice_description> 
<Choice_value>l</Choice_val"ue> 
</Choice> 
<Choice> 

<Choice_description> 

C: \SmartOutcall\Sounds\purchase__movie_video.wav 
</Choice_de script ion> 
<Choice_value>2</Choice_value> 
</Choice> 
<Transf er> 

<Transf er__description> u Kathy 1 s phone "</Transfer_description> 
< Tran s f er_number >4 939880</ Tr ans f e r_number > 
</Transf er> 
</Choices> 
</Multicall> 
</0utcall service> 
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2. Per-call IVR definition file: OP1 short.xml 



This XML file defines an outcall request using the current content definition (see the 
previous XML file) by specifying a 10-digit phone number to be called (9252517200) 
and the 4-digit passcode (4321) to determine if the person who answers the call is really 
"John Smith" as authorized to hear the subsequent audio content. 



<?xml version^ ' 1 . 0 f ?> 

<Outcall service title= "Outcall Test P file"> 
<Percall> 

<Call id="12345"> 
<Call_inf o> 

< Phone__numbe r>9252517200</ Phone_numbe r > 
</Call_inf o> 
<Authentication> 

<Authentication_code__description> 

"your authentication code" 
</Authentication_code_description> 
<Authentication_code>4321</Authentication__code> 
</Authentication> 
<Introduction> 

<Sender>"Test system" </Sender> 
<Recipient> " John Smith" < /Recipient > 
< / Introduct ion> 
</Call> 
</Percall> 
</Outcall service> 



Generic Dialog Sample 

User: Hello. 

System: Hello. This is an automated call for <Recipient> from <Sender>. If you are <RecipienP% 

please enter <Authentication_code_description> followed by the pound key. 
User: Enters < Authentication _code> 
System: I heard digits _entered If this is correct, press one. 
User: Presses 1 

System: Thank you. A message from <Sender> is next. Some important options follow the message. 

The message is less than one minute long. Beginning of message. <Content> End of message. 
That was your message. To hear the message again, press the star key. Please choose from 
one of the following #_choices choices. If you would like <Choice_description(l)>, press 

<Choice_value(l)>. If you would like <Choice_description(2)> press <Choice_value(2) 

If you would like to be transferred to <Transfer_description> ? press 0. 

User: Enters 2 

System: To confirm that you would like <Choice_description(2)> press one. 
User: Enters 1 

System: Your choices of <Choice_description(2)> has been confirmed. Thank you. Good-bye. 
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View Rules 


UID: jsmith 




URL 


Action 


travelocity 


Accept 


roadsideassist 


Prompt 
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Deny 


shopping 


Deny 



Set Rules 
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Site: £ 
Action: P 
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